home *** CD-ROM | disk | FTP | other *** search
/ Over 1,000 Windows 95 Programs / Over 1000 Windows 95 Programs (Microforum) (Disc 1).iso / 0313 / install.txt < prev    next >
Text File  |  1997-03-31  |  11KB  |  275 lines
  1. Installation instructions for PolyCAD v1.0
  2. ------------------------------------------
  3.  
  4. 1. Create a directory where you wish to place PolyCAD and change to that
  5.    directory, e.g. in DOS
  6.  
  7.    C:\>mkdir polycad
  8.    C:\>cd polycad
  9.  
  10. 2. Copy the pcad10.zip file into the newly created directory and unzip it 
  11.    using the -d option,
  12.  
  13.    C:\polycad\>pkunzip -d pcad10.zip
  14.  
  15. 3. Change to the psystem subdirectory in your newly created directory 
  16.  
  17.    C:\polycad\>cd psystem
  18.  
  19.    Copy the following files into your windows system directory (this is 
  20.    usually the directory C:\windows\system),
  21.  
  22.    cmdialog.vbx
  23.    spin.vbx
  24.    threed.vbx
  25.  
  26.    e.g.
  27.  
  28.    C:\polycad\psystem\copy *.vbx C:\windows\system\*.*
  29.  
  30.    Note: PolyCAD also requires Microsoft's Visual Basic run time library file 
  31.    VBRUN300.DLL to be in your windows system directory. This file is NOT 
  32.    included in the PolyCAD package since it is widely available for down-
  33.    loading, e.g. by anonymous ftp from
  34.  
  35.    sunsite.doc.ic.ac.uk 
  36.    in /packages/ibmpc/microsoft/Softlib/MSLFILES/VBRUN300.EXE
  37.    
  38.    or
  39.  
  40.    ftp.microsoft.com 
  41.    in /Softlib/MSLFILES/VBRUN300.EXE
  42.  
  43.    and many other sites.
  44.  
  45. 4. If you have previously installed WinG on your computer goto step 5, 
  46.    otherwise copy the following files into your windows system directory,
  47.  
  48.    dva.386
  49.    wing.dll
  50.    wing32.dll
  51.    wingde.dll
  52.    wingdib.drv
  53.    wingpal.wnd
  54.  
  55.    You may now need to edit your windows system.ini file. Bring this file
  56.    into an editor and find the section [386Enh]. You should look for a line
  57.    similar to
  58.  
  59.    DEVICE=C:\WINDOWS\SYSTEM\DVA.386
  60.  
  61.    If this line is not present you should add it under the [386Enh] section
  62.    and save the system.ini file.
  63.  
  64.    If you have edited the system.ini file under windows you will need to exit
  65.    and restart windows for this change to take effect.
  66.  
  67.  
  68. 5. If you wish you may now remove all the files in the C:\>polycad\psystem
  69.    directory and remove that directory since it is no longer required.
  70.  
  71.  
  72. 6. Start up windows if you have not already done so. 
  73.  
  74. 7. Open the group you wish to place PolyCAD in by double clicking on it.
  75.  
  76. 8. Select the menu command File->New...
  77.  
  78.    Choose OK to Program Item
  79.  
  80.    Fill in: 
  81.  
  82.    Description:        PolyCAD
  83.    Command Line:       polycad.exe
  84.    Working Directory:  c:\polycad  (the directory you unzipped pcad10.zip in)
  85.  
  86.    and choose OK.
  87.  
  88. 9. Start PolyCAD by double clicking on its icon. Note that if you have just
  89.    installed the WinG files you will first see a window with a strange 
  90.    display as WinG tests your computer system for optimal performance. This
  91.    may take a few minutes depending on your computer setup. Once this is
  92.    finished you will not see it again unless you change the display driver
  93.    in your windows setup.
  94.  
  95. 10. PolyCAD works best in a 256 colour mode under Windows 3.1.
  96.  
  97.  
  98. 11. Microsoft have listed some known problems with WinG 1.0 and certain
  99.     display drivers. We have included below the readme.txt file (copyright
  100.     Microsoft Ltd) from the WinG development kit:
  101.  
  102. =============================================================================
  103.  
  104. Microsoft WinG version 1.0
  105. --------------------------
  106. This file describes known bugs, gotchas, and helpful hints for the WinG
  107. Version 1.0 final release.
  108.  
  109. ISVs may want to distribute portions of this readme file that describe
  110. configuration bugs along with shipping products that use WinG.
  111.  
  112. WinG version 1.0 provides fast DIB-to-screen blts under Windows 3.1,
  113. Windows for Workgroups 3.11, Windows 95, and Windows NT version 3.5.
  114. WinG will not run on Windows NT version 3.1 or on earlier versions of
  115. Windows.
  116.  
  117. WinG requires a 386 or better processor to run. WinG will not run on a
  118. 286.
  119.  
  120. If you have problems with WinG, please run the wingbug.exe file in
  121. the bin directory of the SDK and send the generated report to
  122. wingbug@microsoft.com.  Updated information on WinG is available
  123. on CompuServe in the WINMM forum and on ftp.microsoft.com.
  124.  
  125.  
  126. Known Bugs And Limitations
  127. --------------------------
  128. The following are known problems with or useful tidbits of information
  129. about WinG version 1.0.
  130.  
  131. - On Windows 3.1, WinGBitmaps must be 8 bits per pixel and must be
  132.   created with full 256 entry color tables.
  133.  
  134. - WinGDCs are NOT palette devices. You must change their color tables
  135.   using WinGSetDIBColorTable, not SelectPalette.
  136.  
  137. - WinGBitBlt and WinGStretchBlt only support bltting from WinGDCs to the
  138.   screen.
  139.  
  140. - Using BitBlt and StretchBlt to blt from one WinGDC to
  141.   another can be very slow when a clipping region has been
  142.   selected into the destination.
  143.  
  144. - WinGBitBlt and WinGStretchBlt may return different values than
  145.   StretchDIBits for identical blts.
  146.  
  147. - A few GDI APIs do not work correctly with WinGDCs:
  148.  
  149.     StretchDIBits will not blt 24bpp and 16bpp DIBs into an 8bpp WinGDC.
  150.     FloodFill with a NULL brush draws incorrectly
  151.     FloodFill outside of the bounds of a WinGBitmap can flood the
  152.       entire image
  153.     Brushes created with CreatePatternBrush with a WinGBitmap fault when
  154.       selected into a WinGDC on Win3x - use CreateBitmap(8,8,1,8,0)
  155.     DrawIcon will crash
  156.     WinGBitBlt and WinGStretchBlt will not always blt to the correct
  157.       location when you have changed the Viewport and/or Window origins
  158.       using SetViewportOrg or SetWindowOrg.
  159.  
  160. - You cannot change the origin of halftone brushes created by WinG.
  161.  
  162. - Noticeable timing differences have been found while running the
  163.   WinG profiler on a computer connected to a network. For accurate
  164.   results, disconnect your computer from the network the first time you
  165.   run a WinG application. After the profile is complete, you can plug the
  166.   net in again. NOTE: Microsoft is not liable for any damage you may
  167.   incur by incorrect handling of your computer hardware.
  168.  
  169. - WinGBitBlt and WinGStretchBlt use a slightly different color matching
  170.   algorithm than StretchDIBits when blting an 8-bit image to a 4-bit
  171.   planar display such as a standard VGA. Mixing WinG and
  172.   StretchDIBits on these displays may produce odd results.
  173.  
  174. - WinG relies on the mmsystem timer drivers to determine display
  175.   performance. If mmsystem.dll and timer.drv are not installed
  176.   correctly, the results of the performance test may be incorrect.
  177.   mmsystem.dll should appear on the drivers= line of the [boot]
  178.   section of system.ini, and timer=timer.drv should appear in the
  179.   [drivers] section of system.ini.
  180.  
  181. - WinG version 1.0 does not yet use standard DCI because of time
  182.   constraints.
  183.  
  184. - "Just In Time" debuggers install a fault handler in a chain along
  185.   with the WinG display performance profiler. If your debugger
  186.   reports a fault during the WinG display performance test, pass the
  187.   fault on to Windows instead of invoking your debugger.
  188.  
  189.  
  190. Driver-Specific Problems
  191. ------------------------
  192. WinG depends on Windows display drivers written by independant
  193. hardware manufacturers for much of its speed. Bugs or performance
  194. problems in third-party display drivers may cause problems in WinG.
  195. In many cases, the video card manufacturer has already fixed the bug,
  196. and upgrading your display driver will often clear away problems.
  197.  
  198. There are some specific "bugs" in display drivers of which you should
  199. be aware. The list below is not intended to slight the manufacturer
  200. of any particular card or driver.
  201.  
  202. A list of stress-tested configurations is available on the CompuServe
  203. WINMM forum and ftp.microsoft.com.
  204.  
  205. Some names in this list are trademarks of the respective
  206. manufacturer.
  207.  
  208. - Early drivers for Diamond Viper cards included a "Power Palette"
  209.   option that is no longer supported by Diamond. They recommend that
  210.   you upgrade your drivers if you have this option. WinG may be
  211.   slower when power palette is enabled.
  212.  
  213. - IBM no longer supports the IBM ThinkPad 720c. There are some
  214.   problems using WinG with the ThinkPad 720c display drivers.
  215.  
  216. - Cirrus drivers before version 1.43 have many known bugs which
  217.   have been fixed in the more recent drivers. Be sure to upgrade your
  218.   drivers if you are still running with this version.
  219.  
  220. - Some ATI drivers offer a "Crystal Fonts" option. Turning Crystal
  221.   Fonts on in 8-bit modes sets up a non-palettized driver that can
  222.   slow WinG significantly.
  223.  
  224. - The ATI mach8 Radical drivers cause a number of problems in both
  225.   WinG and in Windows with some versions of the ATI chipset. Be
  226.   aware.
  227.  
  228. - The ATI VGA Wonder drivers (W31-*.drv) will crash during a call to
  229.   StretchDIBits in the profiler.  Users can run the SVGA256.DRV driver
  230.   that shipped with Windows.
  231.  
  232. - Many miro Crystal drivers have problems with StretchDIBits, so they
  233.   crash during profiling.
  234.  
  235. - Early ATI Mach 32 PCI cards have a hardware timing problem and will
  236.   hang while blting.  ATI will replace these cards for no cost.
  237.  
  238. - WinG is incompatible with the #9GXE "TurboCopy" mode.  Use the
  239.   #9 control panel to disable TurboCopy (it is off by default).
  240.   
  241. - WinG uses a GetPixel to synchronize with display hardware when
  242.   writing directly to the screen.  The ATI Mach 32 driver's GetPixel
  243.   does not work properly, so it is possible to use GDI to draw to
  244.   the screen, then use WinG to blt to the screen and have them overwrite
  245.   each other.  Be careful mixing GDI drawing commands and WinG blts
  246.   to the display.
  247.  
  248. - The Orchid mmtllo.drv driver for the Prodesigner IIs has duplicate
  249.   system colors which prevents applications from getting an identity
  250.   palette and greatly reduces the WinG blt speed.  A workaround is
  251.   to set SYSPAL_NOSTATIC mode or use standard the Tseng ET4000 drivers
  252.   instead of the mmtllo drivers.
  253.  
  254.  
  255. A Note on Speed
  256. ---------------
  257. WinG is designed to be the absolute fastest way to blt DIBs under
  258. Windows.  The goal, achieved in many cases, is to blt at memory
  259. bandwidth to the display device.
  260.  
  261. On most 8bpp devices, if you use the recommended DIB format (returned
  262. by WinGRecommendDIBFormat) and set up correct identity palette, you
  263. should get 1:1 blt speeds comparable to BitBlt, which blts device
  264. dependent bitmaps (DDBs) to the display.  The timewing sample
  265. application will show you various blt speeds on your display.
  266.  
  267. The WinGRecommendDIBFormat API will tell you whether to use top-down
  268. or bottom-up DIBs for fastest unclipped 1:1 identity palette blts. If
  269. you plan on using other types of blt (such as stretching or complex
  270. clipping), your application may want to time top-down versus
  271. bottom-up blts itself at run time. See the WinG help file for more
  272. information.
  273.  
  274. =============================================================================
  275.